Cold Funktionen in der XML Datei
Allgemein
Cold Funktionen können in jedem Wert der Cold-Datei verwendet werden, z. B. im Containernamen, im Betreff, im Stichwort, in Kategorien, Abteilungen, Eigenschaften, Verknüpfungen, Berechtigungen und in den Suchbedingungen.
WICHTIG:- Eine Funktion muss immer mit dem Zeichen % beginnen und enden, z. B.
%FILENAME%. - Textwerte werden in einfachen Anführungszeichen geschrieben, z. B.
'Rechnung'. - Je nach Funktion sind Parameter Pflicht.
- Funktionen können verschachtelt werden. Wird das Ergebnis einer Funktion als Parameter einer anderen verwendet, muss es in einfachen Anführungszeichen stehen, z. B.
%LEFT('%FILENAME%', 5)%. Ohne Anführungszeichen wird das Ergebnis als Zahl oder Rechnung gelesen: Vorlaufnullen gehen verloren (aus 00101 wird 101) und ein Bindestrich wird als Minus gerechnet. - Liefert eine Funktion bei einer Kategorie, Abteilung, Eigenschaft, Verknüpfung oder Berechtigung ein leeres Ergebnis, wird dieser Eintrag nicht übernommen. Das Cold-Protokoll meldet das als Warnung „… wird ignoriert“.
Funktionen für den Cold Import
Diese Funktionen liefern Angaben zur Datei, die gerade importiert wird:
- FILENAME – Dateiname
- FILENAMEWITHOUTEXTENSION – Dateiname ohne Endung
- CURRENTDIR – Verzeichnis der Datei
- CURRENTDIRNAME – Name des Ordners, in dem die Datei liegt
Häufig verwendete Funktionen
- IFTHEN – Wenn-Dann-Anweisung
- CASE – Fallunterscheidung mit mehreren Bedingungen
- DATE – Datum formatieren
- INCDAY, INCMONTH, INCYEAR – Datum um Tage, Monate oder Jahre verschieben
- FORMATFLOAT – Zahl formatieren, z. B. mit Vorlaufnullen
- SQL – Wert aus einer SQL-Abfrage
- LEFT, RIGHT, SUBSTRING – Teil eines Textes
- TRIM, LTRIM, RTRIM – Leerzeichen entfernen
Weitere Funktionen
Der Cold Import verwendet dieselben Ausdrücke wie Serienbriefe und die DMS-Beschlagwortung. Neben den oben genannten stehen daher alle Ausdrücke zur Verfügung, z. B. für Bedingungen, Text-, Datums- und Rechenfunktionen. Sie sind im Kapitel Ausdrücke beschrieben. In der Cold-Datei wird jeder Ausdruck zwischen zwei %-Zeichen geschrieben, z. B. %WENN(5 > 4, 'richtig', 'falsch')%.
Ausdrücke, die eine Datenmenge benötigen (z. B. der Wert einer Spalte aus einer Liste), stehen im Cold Import nicht zur Verfügung, weil es dort keine Datenmenge gibt.
siehe auch: Cold Tags